home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 4 / United Public Domain Gold 4.iso / scope / sc168.dms / sc168.adf / Serial / serial.doc < prev    next >
Text File  |  1990-11-16  |  2KB  |  46 lines
  1.  
  2. SERIAL.C - Released date: 21-SEP-1990
  3.  
  4.   By: Ned Kelly
  5.       Arlington, Texas
  6.       817-277-5825
  7.  
  8.   This program is designed to monitor three status lines (DTR, CTS, CD)
  9. on a serial port.  In the event that any status line has changed, an
  10. event is sent to an ARexx task which will decide what to do with the 
  11. event.
  12.  
  13.   Calling sequence is:
  14.      SERIAL p U u [D d] [Q l u v] [L n]
  15.         where 'p' is the name of the ARexx program to be invoked. 
  16.         where 'u' is a unit number of a serial port to watch.  This
  17.               must be a number between '0' and '8'.
  18.               A unit must be sepcified.  There is no default.
  19.               Multiple units may be specified in a single call.
  20.               ie. SERIAL PROGRAM U 3 U 5 U 7 
  21.         where 'd' is a delay in units of 1/50 second to wait between
  22.               checks of the serial port(s). 
  23.               Default is 50 (ie. one second).
  24.         The program will terminate under one of two conditions.  
  25.         If neither the 'Q' nor the 'L' option are specified, 
  26.         the program will do it's thing once and then terminate.
  27.            If the 'Q' option is specified, then the program will 
  28.               terminate when line 'l' (which may be either 'CD', 'CTS', 
  29.               or 'DSR') on unit 'u' (which may be a number from '0' 
  30.               through '8') becomes value 'v' (which may be either 
  31.               '0' or '1').
  32.            If the 'L' option is specified, then the program will 
  33.               loop through 'n' times and then quit.
  34.      When a status line has changed, program will issue the command:
  35.         rx p SERIAL [l u v] 
  36.            where 'l' is the name of a status line which will be either 
  37.                  CD, CTS, or DSR
  38.            where 'u' is the unit number of the serial port which will
  39.                  be a number from '0' through '8'.
  40.            where 'v' will be either a '0' or a '1'.
  41.                  'v' will be '0' if the status line is open 
  42.                      (not grounded).
  43.                  'v' will be '1' if the status line is closed
  44.                      (grounded).
  45.  
  46.